TikTok Keywords Discovery Scraper

Find TikTok keyword ideas, autocomplete phrases, and long-tail search terms from public TikTok search preview data.

Use it for TikTok SEO, creator briefs, content calendars, product research, paid social planning, and recurring trend tracking.

The actor accepts seed keywords or TikTok search URLs, expands them, deduplicates suggestions, and saves clean rows you can export or use through the Apify API.

🚀 What does TikTok Keywords Discovery Scraper do?

TikTok Keywords Discovery Scraper turns seed terms into TikTok search suggestions.

For each seed keyword, it calls public TikTok web search preview endpoints and extracts suggested search phrases.

It can also run A-Z expansions such as makeup a, makeup b, or meal prep c for deeper long-tail discovery.

The output is structured for analysis, not screenshots or raw HTML.

You get the original seed, the exact suggestion, rank, region, language, search URL, and metadata returned by TikTok when available.

👥 Who is it for?

Content marketers use it to plan TikTok posts around phrases people already search for.

TikTok SEO specialists use it to collect autocomplete terms for optimization briefs.

UGC agencies use it to build creator briefs with real search language.

Ecommerce teams use it to discover product modifiers such as review, dupe, haul, tutorial, before and after, or comparison.

Affiliate publishers use it to find long-tail ideas before producing short-form reviews.

Data teams use it as a lightweight keyword feed for dashboards and trend monitoring.

💡 Why use TikTok keyword discovery?

Manual TikTok autocomplete research is slow.

It is hard to repeat consistently.

It is hard to export.

It is easy to miss long-tail modifiers.

This actor makes the process repeatable, API-friendly, and ready for scheduled runs.

You can save the same input and compare suggestions week over week.

You can also feed the suggestions into another TikTok video scraper for deeper content analysis.

📦 What data can you extract?

The actor outputs one row per keyword suggestion.

Field	Description
seedKeyword	Original keyword used as the discovery seed
expansionKeyword	Exact query sent to TikTok, including A-Z suffixes when enabled
suggestion	Suggested TikTok search phrase
normalizedSuggestion	Lowercase normalized suggestion for deduplication
suggestionRank	Order returned by TikTok for that query
searchUrl	TikTok search URL for the suggestion
region	Region code used in the request
language	Language header used in the request
groupId	TikTok group identifier when returned
wordsSource	TikTok words source metadata when returned
recallReason	TikTok recall reason metadata when returned
flags	Additional boolean or text flags when returned
fetchedAt	ISO timestamp for the extraction

💰 How much does it cost to discover TikTok keywords?

The actor uses pay-per-event pricing: a small start charge plus a per-item charge for every saved keyword suggestion.

Charge	Free plan	Bronze	Silver	Gold	Platinum	Diamond
Run start	$0.005 per run	$0.005	$0.005	$0.005	$0.005	$0.005
Keyword suggestion saved	$0.000032806	$0.000028527	$0.000022251	$0.000017116	$0.000011411	$0.000010000

Example Free-plan estimates:

Example run	Estimated charge
1 seed × 10 suggestions	about $0.00533
5 seeds × 25 suggestions	about $0.00910
10 seeds × 50 suggestions	about $0.02140
2 seeds with A-Z expansions and 500 saved suggestions	about $0.02140

Actual cost depends on how many unique suggestions are saved. For larger recurring workflows, tiered pricing lowers the per-item cost on higher Apify plans. The Apify Pricing tab remains the source of truth if platform prices change.

🧭 How to use it

1. Open the actor on Apify.

2. Add one or more seed keywords, for example makeup, fitness, or meal prep.

3. Keep Max suggestions per keyword low for your first run.

4. Choose a region and language if your campaign is localized.

5. Enable A-Z expansions when you need broader long-tail coverage.

6. Start the actor.

7. Export the dataset as JSON, CSV, Excel, XML, RSS, or access it through the API.

🔎 Input options

keywords is the main input.

Use it for seed TikTok search phrases such as skincare routine, budget travel, or protein recipes.

searchUrls accepts TikTok search URLs and reads common query parameters such as q, keyword, and search_query.

maxSuggestionsPerKeyword limits unique suggestions saved for each seed.

region sends a two-letter region code to TikTok's public web endpoint.

language sets the request language header, such as en-US or de-DE.

includeAlphabetExpansions queries every seed plus a through z suffixes.

🧪 Recommended input examples

Small test run:

{
  "keywords": ["makeup"],
  "maxSuggestionsPerKeyword": 10,
  "region": "US",
  "language": "en-US",
  "includeAlphabetExpansions": false
}

Long-tail discovery run:

{
  "keywords": ["meal prep", "skincare"],
  "maxSuggestionsPerKeyword": 25,
  "region": "US",
  "language": "en-US",
  "includeAlphabetExpansions": true
}

Search URL run:

{
  "searchUrls": [{ "url": "https://www.tiktok.com/search?q=fitness" }],
  "maxSuggestionsPerKeyword": 20
}

📤 Output example

{
  "seedKeyword": "makeup",
  "expansionKeyword": "makeup",
  "suggestion": "makeup inspo",
  "normalizedSuggestion": "makeup inspo",
  "suggestionRank": 2,
  "searchUrl": "https://www.tiktok.com/search?q=makeup%20inspo",
  "region": "US",
  "language": "en-US",
  "groupId": "",
  "wordsSource": "",
  "recallReason": "",
  "flags": [],
  "fetchedAt": "2026-05-25T09:00:00.000Z"
}

📊 Example workflow: content calendar planning

Start with broad seeds for your niche.

Collect suggestions from TikTok.

Group phrases by intent: tutorial, review, challenge, recipe, ideas, outfit, aesthetic, comparison, and troubleshooting.

Turn each group into weekly video briefs.

Rerun the same input monthly to monitor whether new modifiers appear.

🛒 Example workflow: ecommerce product research

Enter product category seeds such as portable blender, running shoes, or hair oil.

Enable A-Z expansions to reveal buyer modifiers.

Look for phrases containing review, before and after, worth it, dupe, Amazon, TikTok made me buy it, or how to use.

Export suggestions to your merchandising, ads, or creator team.

🧑‍💼 Example workflow: agency reporting

Create a saved input per client.

Schedule recurring runs.

Export CSV or use the Apify API to load results into a dashboard.

Show clients which TikTok search phrases are available for content planning.

Combine the keyword output with video performance data from related TikTok scrapers.

🔗 Integrations

Send output to Google Sheets for editorial planning.

Send output to Airtable for campaign management.

Use Make or Zapier to trigger downstream workflows after each run.

Load the dataset into a warehouse for trend monitoring.

Feed suggestions to TikTok video scraping actors to collect matching posts.

Use the Apify API in your own internal keyword research tools.

🧑‍💻 API usage

Use actor ID automation-lab/tiktok-keywords-discovery.

Node.js example:

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });

const run = await client.actor('automation-lab/tiktok-keywords-discovery').call({
  keywords: ['makeup', 'meal prep'],
  maxSuggestionsPerKeyword: 10,
  region: 'US',
  language: 'en-US',
  includeAlphabetExpansions: false,
});

console.log(`Dataset: ${run.defaultDatasetId}`);

Python example:

from apify_client import ApifyClient
import os

client = ApifyClient(os.environ['APIFY_TOKEN'])
run = client.actor('automation-lab/tiktok-keywords-discovery').call(run_input={
    'keywords': ['makeup', 'meal prep'],
    'maxSuggestionsPerKeyword': 10,
    'region': 'US',
    'language': 'en-US',
    'includeAlphabetExpansions': False,
})
print('Dataset:', run['defaultDatasetId'])

cURL example:

curl -X POST 'https://api.apify.com/v2/acts/automation-lab~tiktok-keywords-discovery/runs?token='$APIFY_TOKEN \
  -H 'Content-Type: application/json' \
  -d '{"keywords":["makeup","meal prep"],"maxSuggestionsPerKeyword":10,"region":"US","language":"en-US","includeAlphabetExpansions":false}'

🤖 MCP setup for Claude and agents

This actor is available through Apify MCP.

Use this MCP server URL when configuring Claude Desktop, Claude Code, Cursor, VS Code, or another MCP client:

https://mcp.apify.com/?tools=automation-lab/tiktok-keywords-discovery

The tools query parameter matters because it exposes this actor directly instead of the full Apify tool catalog.

Claude Code setup:

$claude mcp add --transport http apify-tiktok-keywords "https://mcp.apify.com/?tools=automation-lab/tiktok-keywords-discovery" --header "Authorization: Bearer $APIFY_TOKEN"

Claude Desktop, Cursor, and VS Code MCP JSON config:

{
  "mcpServers": {
    "apify-tiktok-keywords": {
      "url": "https://mcp.apify.com/?tools=automation-lab/tiktok-keywords-discovery",
      "headers": {
        "Authorization": "Bearer ${APIFY_TOKEN}"
      }
    }
  }
}

If your MCP client does not expand environment variables inside JSON, replace ${APIFY_TOKEN} with your Apify API token. Keep the actor-specific tools URL so the client only exposes the TikTok Keywords Discovery tool.

Claude Desktop prompt example:

Use the TikTok Keywords Discovery Scraper to find 30 keyword ideas for vegan meal prep in the US. Return the suggestions grouped by breakfast, lunch, dinner, and snacks.

Claude Code prompt example:

Call automation-lab/tiktok-keywords-discovery with keywords ["skincare routine", "hair oil"] and maxSuggestionsPerKeyword 20. Save the resulting dataset URL in my project notes.

Agent workflow prompt example:

Run TikTok keyword discovery for this product list, then create a CSV of suggested TikTok search URLs for the marketing team.

⚖️ Legality and responsible use

This actor reads public TikTok web preview data.

It does not log in.

It does not access private accounts.

It does not bypass authentication-only features.

Use the output responsibly and follow TikTok terms, Apify terms, and applicable laws in your jurisdiction.

Do not use the actor to collect private or sensitive personal data.

🧯 Troubleshooting

If a seed returns fewer suggestions than requested, TikTok may have returned fewer suggestions for that term.

If a run returns no results, try a broader seed keyword first.

If A-Z expansion takes longer than expected, reduce the number of seeds or lower the per-keyword limit.

If metadata fields are empty, TikTok did not include those fields in the public response.

If localization looks different than expected, test another region and language pair.

🧱 Limitations

This actor discovers keywords and search suggestions.

It is not a TikTok video scraper.

It does not scrape comments, profiles, private content, or authenticated pages.

Suggestions depend on what TikTok returns at run time.

TikTok endpoint changes may require actor maintenance.

🛡️ Reliability notes

The implementation is HTTP-only and lightweight.

It avoids browser automation for faster and cheaper runs.

The actor deduplicates suggestions across seeds and expansions.

It skips empty or malformed suggestions gracefully.

It records fetchedAt so scheduled runs can be compared over time.

✅ Best practices

Start with 1-3 broad seeds.

Review the first dataset before running large A-Z expansion jobs.

Use saved inputs for repeatable monthly tracking.

Keep region and language consistent when comparing runs over time.

Rerun high-value suggestions as new seed keywords.

Combine keyword output with video scraping only after you know which phrases matter.

🧩 Related scrapers

Use related automation-lab actors when you need more TikTok data after keyword discovery.

• https://apify.com/automation-lab/tiktok-scraper

• https://apify.com/automation-lab/tiktok-search-scraper

• https://apify.com/automation-lab/tiktok-trends-scraper

• https://apify.com/automation-lab/tiktok-video-scraper

📚 FAQ

Can I scrape TikTok videos with this actor?

No. This actor discovers keyword suggestions. Use a TikTok video scraper for video details.

Does it need a TikTok account?

No. It uses public web preview data.

Can I choose country and language?

Yes. Use region and language inputs.

Why do some fields come back empty?

TikTok does not always include every metadata field for every suggestion.

Can I schedule this actor?

Yes. Apify schedules are useful for recurring keyword monitoring.

🏁 Getting started checklist

Choose one seed keyword.

Set maxSuggestionsPerKeyword to 10.

Run the actor.

Open the dataset preview.

Export CSV or connect the API.

Increase limits only after confirming the output matches your research goal.